M

StructuralConnectionHandler.Create

Description:
Creates a new instance of a Structural Connection Handler, which defines the connection between given elements.

Remarks:
Elements should be of the following structural categories: framings (OST_StructuralFraming), columns (OST_StructuralColumns), walls (OST_Walls), floors (OST_Floors) or foundations (OST_StructuralFoundations). The first of given elements is set as the primary one.

Overloads (4):

Create(Document,IList[ElementId])

Create(Document,IList[ElementId],ElementId)

Create(Document,IList[ElementId],ElementId,IList[ConnectionInputPoint])

Create(Document,IList[ElementId],String)

[ObsoleteAttribute("This method is deprecated in Revit 2021 and will be removed in the next version of Revit. We suggest you to use either CreateGenericConnection or other Create methods instead.")]
public static StructuralConnectionHandler Create(
	Document document,
	IList<ElementId> idsToConnect
)

<ObsoleteAttribute("This method is deprecated in Revit 2021 and will be removed in the next version of Revit. We suggest you to use either CreateGenericConnection or other Create methods instead.")> _
Public Shared Function Create ( _
	document As Document, _
	idsToConnect As IList(Of ElementId) _
) As StructuralConnectionHandler

[ObsoleteAttribute(L"This method is deprecated in Revit 2021 and will be removed in the next version of Revit. We suggest you to use either CreateGenericConnection or other Create methods instead.")]
public:
static StructuralConnectionHandler^ Create(
	Document^ document, 
	IList<ElementId^>^ idsToConnect
)

Autodesk.Revit.DB.Document

document

The Revit document.
IList<ElementId>

idsToConnect

List of element ids of connected elements.

Return Value StructuralConnectionHandler The newly created connection.

Autodesk.Revit.Exceptions.ArgumentException

It verifies that we have at least one element id in the list.
Autodesk.Revit.Exceptions.ArgumentNullException

A non-optional argument was NULL
Autodesk.Revit.Exceptions.InvalidOperationException

The document is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements).
Autodesk.Revit.Exceptions.ModificationForbiddenException

The document is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements). -or- The document is being loaded, or is in the midst of another sensitive process.
Autodesk.Revit.Exceptions.ModificationOutsideTransactionException

The document has no open transaction.